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INTRODUCTION 


OVERVIEW 
The five utility programs comprising this diskette have varied functions. 


M (Menu) displays the disk directoy and allows you to RUN any BASIC program by just 
typing anumber. This is advantageous both for younger children and adults with two 
left hands. 


LISTER produces a formatted listing of any BASIC program with all of the unprintable 
characters (both inverse-video and control) substituted. You may also print the key 
conversion table, headings and select print line width lines per page and character font, 


COMPARE will analyze two versions of a BASIC program and display or print the lines or 
statements which do not match. 


HEXDUMP will produce a formatted display or listing of either memory locations or disk 
files in the style familiar to most programmers (hex characters and ASCII 
representations), 


SORT is a high-speed sort/merge using a "sub-list" algorithm. This will effectively 
allow the internal sorting of files that are much larger than available memory. Itis a 
"stand-alone" utility that can be used to sort fixed or variable length records of up to 
220 bytes long in either ascending or descending mode on any sort key. 
REQUIRED ACCESSORIES 

24K RAM 

e10 Disk Drive 

ATARI BASIC Language Cartridge 
OPTIONAL ACCESSORIES 


ATARI 25 Printer or equivalent printer 
ATARI 220 Interface Module 


CONTACTING THE AUTHORS 
Users wishing to contact the authors may write to them at} 
163 Coachman Drive North 


Freehold, NJ. 07728 
or call (201) 431-2305 
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M CMENLUD) 


This program will display all of the entries on the disk directory and allow you to 

select one by typing anumber. When you turn on the computer with any diskette 
containing "M" you would just have to type RUN "DM" and the directory will be listed on 
your TV screen. You would then enter the number of the program that you wish to run. To 
load another program you can type RUN "D:M" again and the directory would re-appear. 
Instructions for copying "M" to other diskettes are located at the end of this section. 

"M" can also be automatically loaded if you copy the "AUTORUN.SYS" file to other 
diskettes. 


The ATARI BASIC Language Cartridge must be in the left cartridge slot of your computer. 
Insert any diskette containing "M" into the disk drive. Turn on the disk drive and then 
your computer. The program will load automatically. The following will be displayed on 
your TV screen (note that the program names will be different for each diskette): 


DOS.SYS 

M 

LISTER 
COMPARE 
HE XDUMF 
SORT 

SORT XX 
SORT.SRC 
SORT .OEBSJ 
10 SORT.FIX 
11 SORT.VAR 


SOON & CAB OMe 


Fiqure 1. "MM" display screen. 


As many as 44 file names will be displayed depending on the number of programs 
located on the diskette, If there are more than Z2, the balance will be displayed 

on the right side of the screen. Enter the number of the program that you wish to 

run and press the RETURN key. The prompt "LOADING filename" will appear vertically 
in the center of the diplay and the program will load. If for any reason the 

program cannot be loaded, "M" will display "CANT LOAD filename" and, after a brief 
pause, return you to the same selection prompt. 


You may also type the number "0" instead of one of the numbers appearing on the 
display. This will cause "M" to reload the disk directory and display the new 
index. If you had changed diskettes before typing "0", the directory of the new 
diskette will display and you can load one of those programs. 


"M" will only load BASIC programs that have been SAVEd to diskette (as opposed to 
LISTed), It also cannot load machine language (binary) or ASSEMBLER text Files (for 
example, SORT.OBJ and SORT.SRC on the UTILITY DISKETTE ITI diskette), 


To copy "M" onto other diskettes in your library, first turn on your computer system 

with the UTILITY DISKETTE II diskette. When the READY prompt appears, type DOS and 
press the RETURN key. The ATARI DOS II menu will display. Type "O" for DUPLICATE 
FILE and press RETURN. Follow the instructions issued by DOS regarding inserting 

the source and destination disks. Copy both "“AUTORUN.SYS" and "M" to the new 
diskette. Do not copy "M" to diskettes containing DOS I (09/24/79), "M" will not 

work on the earlier version of DOS, 


LISTER 


LISTER will produce a formatted listing of any BASIC program with the unprintable 
inverse-video and control characters replaced with key symbols. The program to be 
printed must have been LISTed to the disk drive, 


To load LISTER, insert the ATART BASIC Language cartridge in the left cartridge slot of 

your computer. Insert the UTILITY DISKETTE II diskette into your disk drive. Turn on 

the disk drive and then the computer. When the READY prompt appears, type RUN "D‘LISTER" 
and press RETURN. The program will load and display the following: 


FROGRAM LISTER 
(C) 1982 RLM MICRO SYSTEMS 


FROGRAM MUST BE IN LIST FORMAT. JUST 
FRESS RETURN TO CANCEL. 


ENTER FILE NAME =>? 


INSERT XXXXXXXKKX IN DISK DRIVE 
FRESS RETURN 


ENTER ¢ 
PRINT LINE WIDTH =2?75 


[NI NORMAL CCI COMPRESSED TYPE =:?N 
1st HEADER LINE 


° 

2nd HEADER LINE 

if 

# OF LINES/FAGE =2?758 


PRINT KEY LEGEND (Y/N) Y 
Figure 2. LISTER options. 


First, type the name of the program that you want to print. If the program is in 
disk drive 1, you can type either NAME or D‘NAME, If it’s in disk drive #2, you 
must type DZ:NAME. Press RETURN when you are finished. 


Please note that the program to be printed must be in the LIST or “untokenized" 

format (as opposed to SAVE and “tokenized"), If it is not in LIST format, cancel 

LISTER by pressing RETURN without entering the name. Then LOAD the program and LIST 
it to the disk drive (for example, LIST "DSPROGNAME"), 


The next prompt is for the print line width. The number 73 is already displayed on the 
screen. Just press RETURN to enter this default value, Enter any other number (from 40 
to 120) to change the default. The print line width is usually &0 for normal type Font 

and 122 far the condensed (or compressed) type. This parameter controls the width of 
your listing. The smaller the number, the narrower the listing. 


Select normal or compressed type by typing N or C to that prompt. The default is normal, 


If you select normal, the line width entered above cannot be greater than 7%, If it is 
greater, the program will re-display the line width prompt. 


You may now enter two header lines that will be printed on the listing. The first 
header line will also appear at the top of every page on multi-page listings. Just press 
RETURN to skip these options. 


The number of lines per printed page is entered next. The default is 5& and the maximum 
allowed is 63. 


The last parameter controls the printing of the key legend on the first page of the 
listing. If you type "N", 1t will not appear, A "Y" will produce the table shown on the 
sample listing in figure <=. 


The program will then display: 


CHECK FRINTER & FAPER 
PRESS RETURN 


Check that your printer and interface module are on and that the paper is positioned 
correctly in the printer. Press RETURN when you are ready. If the computer cannot send 
data to the printer, the warning will be re-displayed. If you are using a printer other 
than the ATARI e232 (e.g., EPSON MX-&0), see the Advanced Technical Information section 
for instructions on how to modify the program for other printers. 


_ After answering all of the above prompts, the listing will be produced. If a diskette 

related problem occurs during the processing, the message "DISK ERROR - XXX" will be 

displayed followed by "RUN AGAIN (Y/N) 2", The error number (XXX) relates to the error 
messages in the ATARI BASIC REFERENCE MANUAL - Appendix B. To re-run the LISTER program, 
type a "Y" in response to the last prompt. 


COMPARE 


COMPARE will compare two BASIC programs line-by-line and print out all lines which do not 
match in the two programs. The two programs should be different versions of the same 
program. It would be meaningless to compare two totally different programs (all of the 
lines would be different)» COMPARE will output the lines if one of the two programs does 
not have that line number or if the line numbers are equal but the statements are 

different. The "listing" can be on the screen or printer. The programs to be compared 
MUST both be in LIST format. 


To load COMPARE, insert the BASIC cartridge in the left cartridge slot of the computer 

and the APX diskette in the $10 disk drive. Turn on the disk drive first and then the 
computer. When the READY prompt appears, type RUN "D:COMPARE" and press RETURN. The 
program will load and display the following: 


BASTC FROGRAM COMPARISON 
(C) 1982 RLM MICRO SYSTEMS 


FROGRAMS MUST BE IN LIST FORMAT. JUST 
PRESS RETURN TO CANCEL. 


ENTER 3 


FROG 1 FILESFEC =: ? 
PROG 2 FILESFEC =: ? 


FRESS CSFACEI TO STOP 


SELECT? 
[S$] SCREEN CP] PRINTER =2? 
CN] NORMAL CC] CONDENSED TYPE => 


Figure 3. COMFARE options. 


The two program names must be entered first. You may type either the full filespec 
(e.g, DIPROGNAME) or the program name (e.g, PROGNAME). If the programs are not 
located in disk drive 1, then you must type the full filespecification., Press 

RETURN after you enter each one. The programs to be compared MUST be in LIST format 
(as opposed to SAVE format). If they are not, you can convert them by LOADing each 
one and then LISTing each to the disk drive (e.g, LIST DSPROGNAME.LST), 


You then enter your choice of screen display or printer hardcopy. The default is 
the printer. Type over the "P" with an "5" to select the screen. Press RETURN to 
register your selection, 


Please note: when using the screen display and control characters (e.g, 
ESCAPE-CONTROL-CLEAR to clear the screen) output to the display will produce that 
function when printed on the screen. The display may clear or shift dawn by one 

line, etc. 


The final option concerns the selection of either normal or condensed type for the 


hardcopy listing. If you’re using the screen output, this prompt won’t appear. 
If printer output was selected, the program will display: 


CHECK FRINTER & FAPER 

FRESS RETURN TO CONTINUE 
Check that the printer and interface module are on and that the printer is in "on-line" 
mode. If the program cannot send data to the printer, this message will be re-displayed, 
See the Advanced Technical Information Section for instructions on using printers other 
than the ATARI 82z5, 


While the listing 1s being generated on either the printer or screen, you may halt it by 
pressing the SPACE bar. The following prompt will then be displayed! 


CCI CONTINUE CS] STOF 


To continue the operation, type "C". To abort the procedure, type "S". For screen 
output, the display will automatically stop after each page and produce this prompt. 


After all of the program lines have been examined, COMPARE will print an analysis of the 
comparison indicating how many lines are missing or do not match on each of the two 
programs. See figure 6 (page 14) for a sample of this analysis. 

At the end of the processing or if you abort it, the program will display the prompt: 

RUN AGAIN (Y/N) ? 


Type Y to run the COMPARE program again. 


HE XDUMP 


HEXDUMP will produce a formatted dump of either memory locations or disk files. You may 
dump any type of file including BASIC, binary, or data. The output can be directed to 
either the screen or printer. The format is dependent on the output device, producing 
either & byte or 16 byte lines with ASCIT representations of the printable hexadecimal 
values, 


To load HEXDUMP, insert the ATARI BASIC Language cartridge in the left cartridge slot of 

your computer and the program diskette in the disk drive. Turn on the disk drive and 

then the computer. When the READY prompt appears, type RUN"D‘HEXDUMP" and press RETURN. 
The program will load and display: : 


HEX DUMF (Cd 1982 RLM MICRO SYSTEMS 


SQURCE - CMI MEMORY or CDI DISK ? 
FRESS RETURN TO CANCEL 


Type either an "M" for memory locations or "D" for disk files, Press RETURN. If you 
choose the memory option, the following will display: 


ENTER STARTING ADDRESS  (CHEX) 
ENDING ADDRESS CHEX) 


Enter the applicable addresses and press RETURN after each one. 
For the disk file option, the display is: 
ENTER FILE NAME => 


You may enter the filespecification (Dnifilename) or just the file name (filename), Then 
press RETURN, 


The output prompt will then appear: 

OUTPUT -— CSI SCREEN or CRI FRINTER ° 
Type an "S" for screen output or a "P" for the printer. Press RETURN. If you select the 
printer option, the messages "TURN PRINTER ON & CHECK PAPER" and "PRESS RETURN" will 
display. Verify that both the printer and interface module are on and that the printer 


is in "on-line" mode. If the program cannot send data to the printer, this prompt will 
reappear. Press RETURN to begin the process. 


For the printer option, the message "PRESS ANY KEY TO HALT PRINTER" will display. After 
pressing any key, the following prompt will appear on the screen: 


[TC CONTINUE CRI RESTART [TS] STOF 


To continue the listing, type "C". To restart the program, type an"R". To end the 
program and return to BASIC, type an "5S". 


This last prompt will also display when you’ve selected the screen option and the screen 


is filled with HEX characters. Typing "C", "R" and "S" will result in the same action. 
When the disk file or memory locations have been printed, the select "SOURCE" option will 


re-display. If the output went to the screen, you will have to press RETURN to clear 
the last display. The message "EOF" (end of file) indicates this condition. 
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SORT 


SORT is a high-speed sort utility based on a “sub-list" concept. The data file is 

divided into smaller segments that can each be sorted internally in computer memory. The 
small temporary files merge to complete the sort process, Therefore, a file, larger than 
available memory can be re-sequenced. The file can be either fixed or variable length 
records with a minimum record length of 2 bytes and a maximum of 230. The sort key can 
be located anywhere in the record and the program will sort in either an ascending or 
descending order. The utility is designed as a "stand-alone" and does not require 
interfacing with other programs. The source code for the machine language sort routine 
is included on the diskette, 


To load SORT, insert the ATARI BASIC Lanquage cartridge in the cartridge slot of your 
computer and the program diskette in your disk drive. Turn on the disk drive and then 

the computer. When the READY prompt appears, type RUN "DiSORT" and press RETURN. A 
"LOADING SORT/MERGE" message will appear as the machine language routine and main sort 
program are loaded. After the logo appears on the screen, the following will display: 


FOR FILE TO BE SORTED, ENTER: 


FIXED CF) OR VARTABLE LENGTH ° 
RECORD LENGTH ° : 

SORT KEY (Cist,2nd> °°? 

ASCENDING - 0 or DESCENDING - 1 ? 
ENTER FILE NAME (Drnimame.ext) 


DRIVE NUMBER FOR SORTED FILE ? 


INSERT XXXXXXXX IN DRIVE mi 
AND ELANK DISK IN DRIVE rm 
FRESS RETURN 7? 


Figure 4, SORT display 


The first prompt concerns the format of the file that will be sorted. Fixed length 
means that all of the records in the file are exactly the same length. Most DATA files 
processed by programs are of this type. Variable length implies that all of the records 
have different lengths. One may be 40 bytes long, the next may be 45, and so on. TEXT 
Files generally are variable length. If you are not sure of the format of a particular 
file, specify VARIABLE. The algorithm in the variable length sort can handle fixed 
length records. 


The next prompt is for the record length. Enter this number and press RETURN. The 
length must be a number between 2 and 250, The record length will be requested only if 
you had selected the fixed length option, 


The sort key is required next. Enter the beginning and ending positions of the key in 
the record. 


For example, if you are sorting a name/address file on Zip Code, which appears in 


the record in positions 4% through 3, enter 47,23 and press RETURN. The sort key 
must be within the physical record (e.g., you can’t sort on position &2 if the 
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record is only 74 characters long). 


The next prompt concerns the order in which you want to sequence your records - ascending 
or descending. Type a"0" for ascending or a "1" for descending and press RETURN. 
Ascending would put records with lower key values in front of the sequence, descending 
would put them at the rear. 


At this point, one of two programs will load from the diskette containing the sort 
utility, depending on whether you had selected fixed or variable length records. 


You will then enter the name of the file that you want to sort. Enter the complete 

filespec (e.g. DISTESTFILE.DAT) and press RETURN. There must be enough free space on the 
diskette to store half of the file. For example, if the file is 400 sectors long, there 

must be at least 200 free sectors for this temporary storage. Because of this storage 
factor, the largest file that SORT can handle is approximately 470 sectors (470 X 1.5= 

703 sectors), For files this large you must copy the file to a formatted diskette that 

does NOT contain DOS (there are only 6z4 sectors left with DOS on the diskette), 


The last entry that you will make concerns the destination disk for the sorted file. If 
you have one disk drive, you must type a "1" to this prompt. If you have two or more 
drives; you can optionally sort the file onto drive number 2, 3 or 4. Larger files can 
be handled with multiple drives. 


SORT will then begin to sort your file. Numerous system messages will display during 
this process. Depending on the amount memory in your computer and the size of the 
file, SORT will execute either one or two passes to load and sort the records. The file 
D:TEMP is used to store the output of the first pass. Your original file and DiTEMP will 
be deleted at the end of the process. The remaining file (same name as your original) 

is the one that has been sorted to your specifications. If you have two or more disk 
drives and requested that the new file be placed on a different disk, the original will 
NOT be erased. 
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ADVANCED TECHNICAL INFORMATION 


SYSTEM ELEMENTS & DESIGN - SORT 


SORT is comprised of four programs - SORT, SORTXX, SORT.FIX and SORT.VAR. The first 
"POKE’s" the machine language program into memory and then loads the SORTXX program. 
Your initial selections are captured here and poked into memory. The two main programs 
load the file (in one or two passes depending on its size), calls the machine language 

routine to sort the string containing the records, and then optionally merges the two 
smaller files together. If one pass is used to load the data then the last step is not 
executed "SORT.VAR" (variable length) also reads the file first to find the maximum 

record length and then inserts the actual length of the record in front and buffers the 

end with blank spaces. The record length (stored in binary) is used when the file is 
re-written to diskette. 


The parameters controlling the machine language routine (and their memory locations) are} 


Description Decimal Address 

Beqinming of Sort Key 203 

End of Sort Key 204 

Record Lemeth 205 

Type (CAscemdinmga - 0 or 206 
descending - 1) 


Note that the sort key positions are the "offset" of those bytes from the beginning of 
the record. For example, the first byte of the record has a "0" offset, the second is 
"1" and the nth is (n-1). Also, note that the variable length option inserts the record 
length in FRONT of the record, thereby pushing the data back by one position. 


The routine itself resides in memory locations 1644 to 178? (decimal) or 0620 to O4FD 
(hex), A USR function is used to execute the sub-routine. The USR function MUST pass 
two additional parameters to the routine the address of the string containing the file 
and the record count. The statement would be A=USR(1664,ADR(X$),RC), 


Both the BASIC sort/merge routines and the machine language sort can be modified or used 
with other programs. To utilize the machine language routine; you must load the above 
memory addresses with the required parameters and then call it, passing the string 
address and number of records in process. Both the source and object files are on the 
program diskette for those who would like to experiment. You will need an 
ASSEMBLER/EDITOR cartridge to modify the machine language program. 


The BASIC sort/merge programs can also be called from other programs by adding a RUN 
"DiSORT" instruction in your software (note: the SORT program is called first to load the 
machine language routine} it will call SORTXX). Add the code to POKE the above addresses 
with the parameters and remove the prompts within SORTXX, SORT.FIX and SORT.VAR that 
perform this function. The input for the file name can be replaced with "F$=Difilename”. 

The END statement in line 410 may be repalced with RUN "Diprogname" where progname is the 
name of your calling program. 


USING OTHER PRINTERS 


LISTER and COMPARE are coded to work with the ATARI &2Z5 printer. Other printers (e.g,, 
EPSON MX-0) can be used with these programs if you make one change in each of the 
programs. 


First turn on your computer system a DOS II diskette. Insert the program diskette and 
type LOAD "DiLISTER" and press RETURN. The program will load but not execute. Type 
LIST 40 and press RETURN. The following statement will display on your screen: 


4 NSUES se CgaGon 


The variables N$ and C$ represent the printer control codes for the NORMAL and CONDENSED 
type fonts. Locate the printer control codes for these functions in your printer 

instruction manual. The "normal" font is sometimes referred to as “cancel condensed". 
Replace the values assigned to N$ and C$ in the program with those required by your . 

printer. The ATASCIT CHARACTER SET chart in Appendix C of the ATARI BASIC REFERENCE 
MANUAL may help you in converting the decimal or hexadecimal values in the printer manual 
to the required ATASCII characters. Use the cursor control keys (CONTROL and up, down, 
left, right, insert, delete) to move the cursor to the applicable location on line 40 and 

insert the new values. Some printers (e.g., EPSON) use a one character control code 

while others (ATARI $25) use two. Delete the second position if it is not needed, 


Line 40 for an EPSON printer would then look like: 

40 N$="" CH=" g! 
Press RETURN after making the change and then insert the formatted (and un-locked) 
diskette in your disk drive. Type SAVE "D‘LISTER" and press RETURN. The new version of 
the program will be saved on this diskette (NOTE: The UTILITY DISKETTE II diskette does 


not have a notch and is, therfore, write-protected), The COMPARE program can be 
modified in the same manner. 
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FROGRS™ LISTE (C) I9ED FL™ Micese Sveteme 
KEY LEGEND FOR UNSFINTABLE CHARSCTERE 
LETTERS Jt BRACKETS C J ARE INVERSE VIDEO EXCEPT FOF: 


CCON-X2 WHERE x IS €& LETTER FEY 


PCL Eg ESO =SHIF T=-CLEAR CTAB] = ESC-TAER 

CDWNI = ESC-CTRL-EQUAL CUF 3 = ESC-CTRL-MINUS 
LLEF) = ESC-CTRL=FLUES CRITI] = ESC-CTRL-ASTERISt. 
CINSJ = ESC-CTRL-INSERT EDEL?) = ESC-CTRL-DELETE 
CILN3 = ESC-SHIFT-INSERT CDLNIJ = ESC-SHIFT—-DELETE 
[SETI = EStC=SHiFt-TAE CCLTI = ESC-CTRL-TAE 
DReLd =] ESC=CURL=2 


=<C DIM R€(15¢).FP¢ (388).718 (2%). T2¢ (58) Fe (18). TE(15) HIE (75) .H2E (75) AE (2:, 
N€ (2), CE(2) 

of T1is="C(CLRICDWNICUF JCRITICLEFICTABICSETICCLTICINSICDELICILNICDLNICBEL TD": 
T2¢="CLRDWNUF RITLEFTARSETCLTINSDELILNDUNEEL ":LT=LEN(T1¢) 

4¢ N¢&="C(CON-RI":Ce="({CON-OIJ"sPOKE &2. 3] 

we GRAPHICS @:°? “CDWNITTABI {[ PROGRAM LISTER 3":7 "CDWNICTABI(C) 19E2 Fe 
Mm MICRO SYSTEMS": POKrE 16.64: PORE S3774, 64 

6 7 "CDWNIFROGRAM MUST BE IN LIST FORMAT. JUST":?° “PRESS RETURN TO CANTEL. 
7€ FS="Die":P "“"CDWNIENTER FILE NAME ==> “ss: INFUT T¢: IF LEN(T#)=2 THEN 42¢ 
16% TRAF 13@: IF T¢(2.2)2":" OR TE(3.3)="2" THEN Fe=TE:GOTO 136 

110 Fe (4)=T¢ | 

139° TRAF 49669: 7 “INSERT “sF¢:" IN DISH DRIVa': ? “PRESS CRETURNI "ss INPUT T 
3 

Jizz TRAF 982: 0FEN #€2.4.8.F¢:RC=8: TRAP 469608:7 :7 "ENTER: " 

135 PL=75:7 "PRINT LINE WIDTH => 75CLEFICLEFICLEFI"::TRAF 1275: INPUT PL: TRA& 
AAAS” ; 

136 IF PL< 3S OF PL>131 THEN 135 

146 AS=NE:° "CNI NORMAL [C3 COMPRESSED TYPE => NILEFICLEF IJ": : INFUT TE: IF T 
g¢="C" THEN A¢=C¢ 

142 IF AS=Ns AND FPLI7S THEN 7 “FRINT LINE TOC LONG": GOTO 
145 7 "IST HEADER LINE": INFUT Hi: 7 “DND HEADER LINE": INFUT Hos 

146 PN=1:LP=SE: 7 “® OF LINES/PAGE =: SBLLEFICLEFIJCLEFI':s : TRAS Se: INUIT LF 
2>IF LF*6S THEN 146 

147 T=1: 7 "FPRINT KEY LEGEND (Y/N) YEILEFIJCLEFI":: INFUT Ts:I1F Ts Ci,s)<o"Y' 7 
HEN J=¢ 

we CLOSE #2:7 “CHECK FRINTER & PAPER": GQSUE 946 

TRAF 152:O0FEN #2,6.8."F2"3s7 €3:A¢: IF LEN(CHI¢) > THER 7 €3:3;H1E3™ RS2ROHF 


paseo 


rapa 
C+. 
136 IF LEN(H22) 5@ THEN 7 #23:HO¢E: 7 €3:RC=RO+Z 

16% IF J=% THEN 217 7 

165 7 #2," KEY LEGEND FOR UNF'RINTABLE CHARACTERS": 7 #2 

176 7 #3:" LETTERS IN BRACKETS € J] ARE INVERSE VIDEO EXCEPT FOR: ": 7 #7 _ 
171 7 #3:" (CCON-XJ WHERE xX If €& LETTER KEY" 


172 FY #23:" #(CCLRI = ESC-SHIFT-CLEAR CTAB) = ESC-TAR" 

174 ° #2;" (CDWNI = ESC-CTRL-EQUAL Cue J = ESC-CTRL-MINJUE" 

176 7 #2:" (CLEFIJ = ESC-CTRL-PLUS " CRITI = ESC-CTRL-ASTERIS " 
176 7 #2:" CINSJ = ESC-CTRL-INSERT [DEL = ESC-CTRL-DELETE" 
160 FT #33" CILNI = ESC-SHIFT-INSERT CDLN2 = ESC-SHIFT-DELETE"” 
162 7° #2:" (cSETI = ESC-SHIFT-TAE C[CLTI = ESC-CTRL-TAR" 

184 7° #3:" CHELJ = ESC-CTRL-2":7 €3:RC=RE+12 

22 TRAF 46@: INFUT #2,.R¢: TRAD 4908: RO=RC+1 

“16 L=1i:FOR J=1 TO LEN(R#) :G=ASC (RE (ILI) ) 2 IF At B22 OF A124 THEN 225 


TO Peyeaeaae | TSE (CT) !£9FE>2 FL™M Mscerc Svetemrse FAate 


~1E JF Swei THEN Fe (LoOS"I's_s_4+1: Swe 
Sole PS tLe ee C) . ierbole Ie 


aoe IF Swe THEN PS (Loe"C'sL=_+} 
2o7 IF & LES AND @°166 THEN 2éLr 
Se) aa 


<2 IF @2:127 AND AlL2as 
24 JTF G=f THEN FPS (L)="COK-, "sL=l+4:G0TO 3H 
auf IF @:27 THEN 
26G K=@:FORF J=1 TO LT: IF RE (I. J} =T1¢(J.0) THEN 


=6=2 NEXT J:IF kee THEN FPE(L.Lo="?" 

OM LeL+1:Pe(LI=H="9": SWH=e 

212 L=L+1:NEXT I: CH=LEn( FPS) :G=C: Bel | 

Sam IF CFL THEN GFL: IF CoRPL¥2 THEN. B=PL*2 

230 7 #2:PE(1.8):1IF E>G@ THEN 2% #33 F¢ (A+1.B)sRC=RC+1: IF 
»}sRC=RC+1 

SS IF RCXLE THEN 28¢ 

266 FOR I=RC TO 65:7 3: NEXT Is PN=PN+t1:RCH2: 7 €FsH1E:" 


21g 
49 ?°? 3:7 "RUN AGAIN YF CY/N)D “se INEUT TS: IF T#="Y" THEN 


420 GRAFHICS @:END 
SGM CLOSE #2:2 "CRELI DIS!. ERROR- "“3PEEK (19S) :60TO 488 


940 ° "PRESS CRETURNI] WHEN READY": : INPUT Te: RETURN 


Fiqure 5. Sam ple- Lister Outpuct 


THEN FE (L) =CHRE (ASC(RE (1.7) )4+128) 2: SW=1: GOT 


Pe (LY ="CON-" slL=1+4:P¢ (L) =CHRE (ASC (RS (I.1))4+64):G0TC FE. 
P (LI ST2$ (JsS—-S.08f) :Le_-5:! 


m 


CoB THER 7 #2: Fs (E+: 


PAGE "PK: 7 #2:GOTC 


RUN 


ry 


PRUSRoSMc + oS > “Ei: COMPARE 2 ee 
Di: COMPARED. LET 


- - yf Rem TEST VERSION OF COMFARE 
y oS 265 “ “Eller. (Dn:name.ert)" 
1 - 7&5 GOSUE SlO:sNisg=el¢€ 


= BS PbS=lssikLFielet? 47 PRESS CSPACE) TO STOR’: = 
- BS FG=2r:LF=49: 7 :? PRESS CSPACE) TO STOF" 


ae eee 


LINES OF CODE: 
Di: COMPARE).LST - 47 
Di:COMPARES.LST - 46 
DIFFERENCES: 
SAME LINE # - j 
IN D1i:COMPARE].LST ONLY - 2 


IN Di:COMFPARE2.LST ONLY - 1 


Figure. b. Sample Con pare Outmt 


~~ 
e 
e 
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Limited Warranty on Media and Hardware Accessories. We, Atari, Inc., guarantee to you, the original 
retail purchaser, that the medium on which the APX program is recorded and any hardware 
accessories sold by APX are free from defects for thirty days from the date of purchase. Any applicable 
implied warranties, including warranties of merchantability and fitness for a particular purpose, are 
also limited to thirty days from the date of purchase. Some states don't allow limitations on a warranty’s 
period, so this limitation might not apply to you. If you discover such a defect within the thirty-day 
period, call APX for a Return Authorization Number, and then return the product along with proof of 
purchase date to APX. We will repair or replace the product at our option. 


You void this warranty if the APX product: (1) has been misused or shows signs of excessive wear. 
(2) has been damaged by use with non-ATARI Home Computer products; or (3) has been serviced or 
modified by anyone other than an Authorized ATARI Computer Service Center. Incidental and conse- 
quential damages are not covered by this warranty or by any implied warranty. Some states don't allow 
exclusion of incidental or consequential damages, so this exclusion might not apply to you. 


Disclaimer of Warranty and Liability on Computer Programs. Most APX programs have been written 
by people not employed by Atari, Inc. The programs we select for APX offer something of value that we 
want to make available to ATARI Home Computer owners. To offer these programs to the widest 
number of people economically, we don't put APX products through rigorous testing. Therefore, APX 
products are sold “as is,” and we do not guarantee them in any way. In particular, we make no warranty, 
express or implied, including warranties of merchantability and fitness for a particular purpose. We are 
not liable for any losses or damages of any kind that result from use of an APX product. 


For the complete list of current 
APX programs, ask your ATARI retailer 
for the APX Product Catalog 
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PROGRAM 
EXCHANGE 
P.O. Bex 3705 
Santa Ciara, CA 95055 


We re interested in your experiences with APX programs 
and documentation, both favorable and unfavorable. 
Many of our authors are eager to improve their programs 
if they know what you want. And. of course. we want to 
know about any bugs that slipped by us, so that the 
author can fix them. We also want to know whether our 


1. Name and APX number of program. 


Review Form 


instructions are meeting your needs. You are our best 
source for suggesting improvements! Please help us by 
taking a moment to fill in this review sheet. Fold the sheet 
in thirds and seal it so that the address on the bottom of 
the back becomes the envelope front. Thank you for 


_ helping us! 


2. If you have problems using the program, please describe them here. 


3. What do you especially like about this program? 


4. What do you think the program's weaknesses are? 


5. How can the catalog description be more accurate or comprehensive? 


6. On ascaleof 1 to 10. 1 being “poor” and 10 being “excellent”. please rate the following aspects of this program: 


Easy to use 


User-oriented (€.g.. menus. prompts. clear language) 


Enjoyabie 

Seif-instructive 

Useful (non-game programs) 
Imaginative graphics and sound 


Pe a aren eee nee = rae TR om eerie, To Opie! Ee rem eee 


7. Describe any technical errors you found in the user instructions (please give page numbers). 


8. What did you especially like about the user instructions? 


9. What revisions or additions would improve these instructions? 


10. On a scale of 1 to 10, 1 representing “poor” and 10 representing “excellent”, how wouid you rate the user 
instructions and why? 


11. Other comments about the program or user instructions: ° 


Prom 


STAMP 


ATARI Program Exchange 
P.O. Box 3705 
. Santa Clara. CA 95055 


{seal here; 


